home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / dbase / dbschn.zip / DBSCHN.DOC next >
Text File  |  1992-08-14  |  3KB  |  119 lines
  1.     dBase Schema Utility version 1.0 by Dong W. Pak       8/15/92.
  2.  
  3.  
  4.         DBSCHN.EXE is an utility program for dBase III and up user.  Its
  5.         intention is to provide a simple way to manage a database.  Database
  6.         is a collection of data files and index files.  This version is
  7.         similar to DBSCH.EXE except that DBSCHN.EXE creates/uses NDX index
  8.         rather than MDX index.  DBSCH.EXE should have named DBSCHM.EXE.
  9.  
  10.         Input to DBSCHN is a schema like file.  This file describes the
  11.     database.  It is a text file.  It has its own format and user must
  12.     follow the format.
  13.  
  14.         Output from DBSCHN of this version is the database described in the
  15.     schema file.
  16.  
  17.  
  18.     Basic format of the schema file is shown below.
  19.  
  20.         comment area.
  21.  
  22.         #SCHEMA name-of-the-database
  23.  
  24.         comment area.
  25.  
  26.         #DEFINITION
  27.             field-name type length decimal ; comment line
  28.             ...
  29.             field-name type length decimal ; comment line
  30.         #END DEFINITION
  31.  
  32.         comment area.
  33.  
  34.         #DATAFILE data-file-name
  35.             #FIELDS field-name
  36.                     field-name
  37.                     ...
  38.                     field-name
  39.  
  40.             #INDEXES index-name unique expression
  41.                      ...
  42.                      index-name unique expression
  43.         #END DATAFILE
  44.  
  45.         comment area.
  46.  
  47.         .... more of #DATAFILE and #END DATAFILEs
  48.  
  49.         #END SCHEMA
  50.  
  51.         comment area.
  52.  
  53.     A line in the file can be blank, predefined word, data, or comment.
  54.     Predefined words are "#SCHEMA", "#DEFINITION", "#END DEFINITION",
  55.     "#DATAFILE", "#FIELDS", "#INDEXES", "#END DATAFILE", and "#END SCHEMA".
  56.     The predefined words are not case sensitive.  "name-of-the-database",
  57.     "field-name", "type", "length", "decimal", "data-file-name",
  58.     "index-name", "unique", and "expression" are considered data.
  59.     Comments are words in comment area and words following the ";" only
  60.     in "#DEFINITION" block.
  61.  
  62.     Sample schema file might look like below.
  63.  
  64.         This is a sample schema file.
  65.  
  66.         #SCHEMA mydbase
  67.  
  68.         "mydbase" is the name of the database that this schema file
  69.         is defining.
  70.  
  71.         #DEFINITION
  72.             NAME    C 30 0 ; name of a person.
  73.             STREET1 C 30 0 ; street
  74.             STREET2 C 30 0 ; another street
  75.                            ; there can be more street you know.
  76.             CITY    C 20 0 ; city
  77.             STATE   C 2  0 ; 2 character state
  78.             ZIPCODE C 5  0 ; which is it 5 or 9.
  79.             PHONE   C 13 0 ; (XXX)XXX-XXXX
  80.         #END DEFINITION
  81.  
  82.         That is the end of mydbase's field definition.
  83.  
  84.         #DATAFILE friends
  85.             #FIELDS NAME
  86.                     STREET1
  87.                     STREET2
  88.                     CITY
  89.                     STATE
  90.                     ZIPCODE
  91.                     PHONE
  92.  
  93.             #INDEXES NAME  N NAME
  94.                      PHONE Y PHONE
  95.                      ZIPCODE N ZIPCODE+NAME
  96.         #END DATAFILE
  97.  
  98.         That is the end of data fiel definition.
  99.         We'll define only one data file for now.
  100.  
  101.         #END SCHEMA
  102.  
  103.         That indicates the end of our sample schema file.
  104.  
  105.  
  106.         To use the above schema file, type DBSCHN and <RETURN>.
  107.     That will provide usage information.
  108.  
  109.     If a command you selected does not do anything then it is not
  110.     yet implemented.
  111.  
  112.     The program is shareware, there is no fee in using or distributing
  113.     the program.
  114.  
  115.  
  116.     Write to me at Route 1 Box 1724-7, Bowersville, GA  30516 for
  117.     any kind of help, critiques, or requests.
  118.  
  119.